home *** CD-ROM | disk | FTP | other *** search
/ The Business Master (3rd Edition) / The Business Master (3rd Edition).iso / files / utilreen / vptvga / vpt.man < prev    next >
Text File  |  1991-12-29  |  20KB  |  483 lines
  1.                      ▄▄▄▄  ▄   ▄   ▄  ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄  ▄▄▄▄
  2.                      █  ▀  █   █   █  █                █  ▀
  3.                      █     █   █▄▄▄█  █▄▄▄  █▀▄▀█  █   █   
  4.                      █     █▄▄▄  █       █  █ █ █  █   █   
  5.                      █▄▄█  ▄▄▄▄▄▄▄▄▄▄▄▄▄▄█  █ █ █  █   █▄▄█
  6.                                         
  7.  
  8.               ┌──────────────────────────────────────────────────┐
  9.               │                                                  │
  10.               │   V I D E O   P A L E T T E   T O O L   V4.15    │
  11.               │                                                  │
  12.               └──────────────────────────────────────────────────┘
  13.  
  14.        Programs and Documentation are Copyright 1991 by clySmic Software.
  15.                               All rights reserved.
  16.  
  17.                                         
  18.  
  19.      I. INTRODUCTION
  20.  
  21.      This program allows VGA and MCGA users to:
  22.  
  23.      ■    View the quarter-million VGA colors available on their systems,
  24.  
  25.      ■    Set any text-mode attribute (0 - 15) to any color out of the
  26.           quarter-million,
  27.  
  28.      ■    Control the overscan (a.k.a. border) color (not available on MCGA
  29.           systems),
  30.  
  31.      ■    Have the colors "stick" with almost all programs,
  32.  
  33.      ■    Load and save their favorite settings in color files, and
  34.  
  35.      ■    Use the program in a command-line mode (for batch file use).
  36.  
  37.      
  38.  
  39.      II. WHAT'S NEW
  40.  
  41.      a.   Improved error handling during file processing, especially for
  42.           network use.
  43.  
  44.      b.   The VPTDIR environment variable, which allows the user to control
  45.           where the .VPT files are loaded and stored.  This is mostly for
  46.           network use.  See section IX, below, for details.
  47.  
  48.      c.   Can press ScrollLock key to "lock" together all the sliders.
  49.  
  50.      d.   Now VPT is "reminderware."  Sorry, but its necessary.  The
  51.           easiest workaround is to register the software!  VPT will remind
  52.           you every time in full-screen mode, and 1 out of 20 times in
  53.           command-line mode.
  54.  
  55.      e.   VPT "remembers" the last file you used and the last attribute you
  56.           were working on (this works only if VPTRES is loaded).
  57.  
  58.      f.   *Much* faster color loading, due to the use of direct access to
  59.           the DAC registers, rather than going through the BIOS.  The BIOS
  60.           calls are either slow or cause severe flickering.
  61.  
  62.      g.   Home and End now adjust the color of the slider you're working
  63.           on, use X or Escape to exit.
  64.  
  65.      h.   A completely new and much better scheme to get the colors to
  66.           stick during a mode change.  This involves a small terminate-and-
  67.           stay-resident program called VPTRES.  MCGA users and those who
  68.           don't want a TSR (its really small) can still use VPT in the old
  69.           manner, without VPTRES.  It is highly recommended though as an
  70.           improved way of controlling colors.  See the TECHNICAL
  71.           INFORMATION section, below, for the gory details.
  72.  
  73.      i.   During loading you can press F1 for a directory of all the .VPT
  74.           files in the directory that VPT was run from.  You can scroll
  75.           through this list and select a file for loading.
  76.  
  77.      j.   Networking functions include: network-aware file handling and
  78.           network user "home directory" support.
  79.  
  80.      
  81.  
  82.      III. FILES INCLUDED
  83.  
  84.      ■ VPT.EXE................The Video Palette Tool.
  85.      ■ VPTRES.COM.............Resident portion of the VPT system (optional,
  86.                               but recommended).
  87.      ■ VPT.MAN................Documentation file.
  88.      
  89.      ■ LOCK.COM...............A small TSR that locks EGA and VGA palette
  90.                               registers (use only if needed).  Registered
  91.                               version only.
  92.      ■ SEL.EXE................An ANSI color setting program.  Registered
  93.                               version only.
  94.      ■ VPTLOAD.EXE............VPT color file loader for OS/2 full-screen
  95.                               sessions.  Registered version only.
  96.      ■ TSTPATN.EXE............A television test pattern simulator.
  97.                               Registered version only.
  98.      
  99.  
  100.      IV. LOADING THE RESIDENT PORTION
  101.  
  102.      Command: VPTRES
  103.  
  104.      If you try to load VPTRES more than once, it will print an error
  105.      message and exit.  I recommend you place this command in your
  106.      AUTOEXEC.BAT file.  VPT will run without VPTRES, but VPT runs much
  107.      better with it.  VPTRES is very small and doesn't use any "hot-keys".
  108.  
  109.      VPTRES has two options: /R which will let you reload VPTRES even
  110.      though its been loaded before.  This is primarily useful for
  111.      environments like Windows 3.0.  The other option is /Q, a "quiet"
  112.      switch that suppresses the program's identification message.
  113.  
  114.      
  115.  
  116.      V. USING VPT'S INTERACTIVE MODE
  117.  
  118.      Command: VPT
  119.  
  120.      VPT operates in text mode and allows setting of any or all of the
  121.      sixteen attributes available in text mode.  There are three sliders
  122.      (one each for Red, Green, and Blue), each of which can assume any of
  123.      64 values (0 through 63).  The current values are displayed next to
  124.      the sliders on the right side of the screen.
  125.  
  126.      Key(s)                   Action
  127.      ─────────────────        ────────────────────────────────────────
  128.  
  129.      Left/Right Arrows        Moves the R,G, or B slider between 0 and 63
  130.                               to control the intensity of the R, G, or B
  131.                               signal.
  132.  
  133.      Control Left/Right       As above, but moves five positions instead of
  134.                               one.
  135.  
  136.      Home/End                 Moves slider directly to 0 (Home) or 63
  137.                               (End).
  138.  
  139.      Up/Down Arrows           Select between the Red, Green, and Blue
  140.                               sliders.
  141.  
  142.      PageUp/PageDown          Selects an attribute between 0 and 15 to work
  143.                               with.
  144.  
  145.      A                        About VPT.  Shows licensing and copyright
  146.                               information about VPT.
  147.  
  148.      B                        Backdrop mode.  This makes the current
  149.                               attribute the background and places text with
  150.                               all sixteen attributes on the screen so you
  151.                               can see the combinations.  Any key exits this
  152.                               mode.
  153.  
  154.      D                        Loads the Default, boot-up colors.
  155.  
  156.      L                        Loads the colors from a file of your choice,
  157.                               if no file is specified, STD.VPT is assumed.
  158.                               You don't need to add the .VPT extension.
  159.  
  160.      O                        Sets the Overscan (border) color to the
  161.                               current attribute.  Not available on MCGA
  162.                               systems.
  163.  
  164.      S                        Saves the colors to a file of your choice, if
  165.                               no file is specified, STD.VPT is assumed.
  166.                               Note: all .VPT files are saved to the
  167.                               directory VPT was run from, NOT the current
  168.                               directory (unless VPT.EXE is there!).
  169.  
  170.      T                        Automatically loads the sTandard color file,
  171.                               STD.VPT.  This is the same using Load and
  172.                               typing STD <Enter>; its just easier.
  173.  
  174.      X or Escape              Exits VPT.
  175.  
  176.      
  177.      Keys Used While Loading or Saving a File:
  178.      ─────────────────────────────────────────
  179.  
  180.      F1                       Available during loading only.  Replaces the
  181.                               file with the first entry in a sorted list of
  182.                               .VPT files in the directory VPT was run from.
  183.  
  184.      Backspace                Erases the last character in the file name.
  185.  
  186.      Ctrl-Backspace           Erases all the characters in the file name.
  187.  
  188.      Escape                   Abandon the load or save.
  189.  
  190.      Enter                    Finishes entry of the filename and performs
  191.                               the operation.
  192.  
  193.      
  194.      Keys Used While Looking at a Directory with F1
  195.      ──────────────────────────────────────────────
  196.  
  197.      Up/Down Arrows           Scrolls through the directory of .VPT files.
  198.  
  199.      Home                     Goes to the beginning of the sorted directory
  200.                               list.
  201.  
  202.      End                      Goes to the end of the sorted directory list.
  203.  
  204.      Escape                   Abandon the load.
  205.  
  206.      Enter                    Select the displayed filename and perform the
  207.                               operation.
  208.  
  209.      
  210.  
  211.      VI. USING VPT'S COMMAND-LINE MODE
  212.  
  213.      Command: VPT [option]
  214.  
  215.      Where [option] is one of the following (capitalization does not
  216.      matter):
  217.  
  218.      /L [filename]            This loads the specified file, if there is
  219.                               one.  If there isn't, you will get an error
  220.                               message.  If [filename] is not specified,
  221.                               STD.VPT will be assumed.
  222.  
  223.      /C [filename]            Like /L above, but does an ANSI clear screen
  224.                               afterwards and displays no messages.
  225.  
  226.      /D                       This loads the default palette.  These are
  227.                               the colors assigned by IBM and are the ones
  228.                               you would see if you didn't use VPT.
  229.  
  230.      /X                       Only available if VPTRES is not resident,
  231.                               this option resets the "palette load on mode
  232.                               change" option to true (see TECHNICAL
  233.                               INFORMATION, below, for an explanation).
  234.  
  235.      /H                       Displays color numbers in hexadecimal.
  236.  
  237.      /I                       Checks for program code file integrity.  If
  238.                               VPT reports that the code file has been
  239.                               corrupted, VPT.EXE has been altered,
  240.                               accidentally or otherwise.  Do not use VPT if
  241.                               this check fails!!  Not foolproof, but better
  242.                               than nothing.
  243.  
  244.      /?                       Presents a help list recapping your options,
  245.                               indicates whether VPTRES is resident or not,
  246.                               and displays the directory VPT will use to
  247.                               load and save files.
  248.  
  249.      Any other option will generate an error message.
  250.  
  251.      The main reason for command-line mode is to include VPT in batch
  252.      files.  First you would run VPT interactively, find the colors you
  253.      like, save them in the STD.VPT file, then include a line like the
  254.      following:
  255.  
  256.      VPT /L or
  257.  
  258.      VPT /C
  259.  
  260.      in your batch file.  This will load your saved colors when you run the
  261.      batch file.  VPT.EXE should be placed in a directory on your PATH.  If
  262.      you don't wish to see the informational messages produced by VPT in
  263.      command-line mode, you can redirect the output to the null device
  264.      (a.k.a. the bit bucket) as follows:
  265.  
  266.      VPT /L >NUL:
  267.  
  268.      Note that error messages *cannot* be redirected and will still be
  269.      seen.
  270.  
  271.      If there are any errors, the DOS ERRORLEVEL is set to 10.
  272.  
  273.      
  274.  
  275.      VII. MORE EXAMPLES
  276.  
  277.      vpt /l mycol             Loads the color file MYCOL.VPT.  This assumes
  278.                               you created such a file using the interactive
  279.                               mode of VPT.
  280.  
  281.      vpt /c                   Loads STD.VPT and clears the screen.
  282.  
  283.      vpt /?                   Brings forth help.
  284.  
  285.      vpt /i                   Runs the integrity check.
  286.  
  287.      An example batch file:
  288.  
  289.      @echo off
  290.      rem THIS BATCH FILE RUNS DULLAPP, WHICH, SINCE IT USES ONLY LIGHT
  291.      rem GRAY AND BLACK, IS A GOOD CANDIDATE FOR ADDING COLOR
  292.      
  293.      rem LOAD DULLAPP COLOR SET (DULL.VPT)
  294.      vpt /l dull >nul:
  295.      
  296.      rem RUN THE PROGRAM
  297.      cd \dull
  298.      dullapp
  299.      cd \
  300.      
  301.      rem RE-LOAD STANDARD COLOR SET (STD.VPT) AND CLEAR THE SCREEN
  302.      vpt /c
  303.  
  304.      
  305.  
  306.      VIII. OVERRIDING THE DEFAULT DIRECTORY AND NETWORK USAGE
  307.  
  308.      To override VPT's use of its own directory (the directory it was run
  309.      from) for color file storage, you can define a DOS environment
  310.      variable naming the location you wish to use.  For example, to use the
  311.      C:\FOOBAR\ZUUL directory to load and save your colors files, enter:
  312.  
  313.      SET VPTDIR=C:\FOOBAR\ZUUL
  314.  
  315.      at the DOS prompt.  This command can, of course, be placed in a batch
  316.      file.  To see what directory VPT is currently using, type VPT /?.
  317.  
  318.      Another use of this command is when VPT is run from a network server.
  319.      Let us say that VPT is located on the Z: drive, and each user's home
  320.      directory is defined as drive F:.  In order for the users to share
  321.      VPT's code, but each have their own color files, you would use a set
  322.      statement:
  323.  
  324.      SET VPTDIR=F:\
  325.  
  326.      in each user's environment.  This would most likely be done when the
  327.      user logs on.  Now the VPT.EXE file can reside on a drive that the
  328.      user only has permission to read & execute.
  329.  
  330.      
  331.  
  332.      IX. TECHNICAL INFORMATION
  333.  
  334.      ■ GENERAL
  335.  
  336.      VPT works by manipulating the DAC (digital to analog converter) color
  337.      registers; each register (there are 256, to allow for the 300x200x256
  338.      mode) contains 18 bits, 6 each for Red, Green, and Blue.  Each RGB
  339.      value can go from 0 to 63, all the combinations makes for 262,144
  340.      possible colors.  You can show up to sixteen of these at a time in the
  341.      text modes, each of the sixteen "attributes" can be any color (or all
  342.      the same color) out of the quarter-million.
  343.  
  344.      ■ VIDEO MODE SETS
  345.  
  346.      a)   Old method, used by pre-4.xx versions of VPT and still available
  347.           with VPT 4.14 if VPTRES is not resident.
  348.  
  349.      Normally BIOS resets the EGA and DAC color registers whenever a mode
  350.      set is done.  VPT without VPTRES makes its colors stick across a mode
  351.      set by using the "Default Palette Loading During Mode Set" BIOS call
  352.      to disable this action.  If you desire to return this to its default,
  353.      boot-up condition, use VPT /X.  Then a subsequent mode set, like MODE
  354.      CO80, will cause the default conditions to prevail.
  355.  
  356.      b)   New, much better, method, used by VPT 4.14 with VPTRES resident.
  357.  
  358.      VPTRES creates a table and a pointer to VPT's colors that BIOS uses
  359.      whenever a mode set is done.  This ability to override the defaults is
  360.      built into the VGA BIOS.  You don't need to (and can't) use VPT /X
  361.      when using VPTRES.  You also don't need to use VPT /C when exiting
  362.      from graphics programs to "reset" the colors.  All told, a much better
  363.      way to make DAC colors sticky.
  364.  
  365.      ■ COLOR FILES
  366.  
  367.      The saved color files have an extension of .VPT which you NEVER need
  368.      to type when using VPT.  For DOS 3.x/4.x users, they are stored in the
  369.      same directory that VPT is run from.  For instance, say VPT is stored
  370.      in the C:\BIN directory, that directory is on your PATH, and you are
  371.      in C:\ZUUL.  When you run VPT, DOS will find it on your PATH in C:\BIN
  372.      and run it.  The color files will also be loaded and stored in C:\BIN.
  373.      For DOS 2.x users, the file will be stored in the root directory
  374.      because DOS 2.x doesn't provide the information to determine where a
  375.      program is run from.
  376.  
  377.      VPT attempts to check for a valid color file by not loading any files
  378.      that aren't exactly 49 bytes long.  You will get a 'bad color file'
  379.      message.  If a file is 49 bytes long and has a .VPT extension but
  380.      *isn't* a VPT color file, it will get loaded anyway.  The colors
  381.      should be interesting.
  382.  
  383.      ■ REFERENCES, &c.
  384.  
  385.      VPT was written based on technical information from the book
  386.      "Programmer's Guide to PC & PS/2 Video Systems" by Richard Wilton and
  387.      IBM's "Display Adapter/2 Technical Reference".  Assembler routines to
  388.      load the DAC registers came from on-line code examples and the "V7VGA
  389.      Technical Reference Manual" by Video-7.
  390.  
  391.      VPT, TSTPATN, and SEL were written in Turbo Pascal and Assembler.
  392.      VPTRES and LOCK were written entirely in Assembler.
  393.  
  394.      
  395.      X. CAVEATS
  396.  
  397.      EGA-aware and VGA-aware programs still will run with their own colors,
  398.      almost all other programs will use the colors VPT sets.
  399.  
  400.      VPT now uses direct hardware access to the DAC color registers.  VPT
  401.      has been tested on true-blue VGAs and Video-7's FastWrite VGA with
  402.      BIOS version 1.18.
  403.  
  404.      Note: VPTRES will NOT work on FastWrite VGAs with a BIOS version less
  405.      than 1.18 due to bugs in the Video-7 BIOS.  FastWrite users can still
  406.      use VPT without VPTRES, or can obtain a BIOS upgrade from Video-7.
  407.  
  408.      
  409.  
  410.      XI. OTHER INCLUDED PROGRAMS
  411.  
  412.      ■ LOCK.COM
  413.  
  414.      If you want to "lock" the colors you set against any EGA/VGA-aware
  415.      programs that try to change them using BIOS: set your colors, then run
  416.      the TSR program LOCK.COM included in this package.  This program can
  417.      be removed and re-run by using a TSR control package like TurboPower's
  418.      excellent MARK and RELEASE (version 2.2 or later).  Note: VPT will not
  419.      be able to reset your colors after LOCK is run.  To reset them, remove
  420.      LOCK, reset, then run LOCK again.  Use LOCK *only* if you need to.
  421.  
  422.      ■ TSTPATN.EXE
  423.  
  424.      This is a silly program that displays a test pattern to see what
  425.      various colors look like with lots of text and various lines on the
  426.      screen.  Also great for simulating 1960s TV circa 3 A.M.
  427.  
  428.      ■ SEL.EXE
  429.  
  430.      An easy ANSI color selector for those who use ANSI.SYS or a similar
  431.      ANSI screen driver.  Allows easy color selection using one or two-
  432.      letter color mnemonics instead of the ANSI color numbers.  Type SEL /?
  433.      for instructions.
  434.  
  435.      ■ VPTLOAD.EXE
  436.  
  437.      This is a program for OS/2 users that will load color files created by
  438.      VPT.  This is just a loader, not a full port of VPT, but combined with
  439.      running VPT in the DOS box, it gives OS/2 users access to all the
  440.      colors in their full-screen sessions.
  441.  
  442.      
  443.  
  444.      XII. SHAREWARE/LEGAL/MONEY STUFF (REGISTER NOW!!!)
  445.  
  446.      VPT is copyright 1991 by clySmic Software (Ralph B Smith Jr,
  447.      President/Chief Programmer).
  448.  
  449.      VPT is released as Shareware.  If you find this program useful, please
  450.      send clySmic software $25.00 as a registration fee for EACH machine
  451.      (including network copies) it is executed upon.  You will receive by
  452.      mail a non-reminding version of VPT, and the extra accessory programs
  453.      mentioned herein.
  454.  
  455.      You may copy the program and distribute it without charge for non-
  456.      commercial, non-governmental use.  You may not sell or otherwise
  457.      charge for VPT.  However, users' groups may charge a small fee (not to
  458.      exceed $10) for media and postage.  Commercial and governmental users
  459.      are REQUIRED to pay the user fee.  Please be certain that all files
  460.      are kept together.
  461.  
  462.      This program is provided AS IS without any warranty, expressed or
  463.      implied, including but not limited to fitness for a particular
  464.      purpose.  So there.
  465.  
  466.      clySmic Software is not responsible for anything that may happen when
  467.      you use VPT, including hardware damage or information loss.
  468.  
  469.      PLEASE NOTE THE NEW PO BOX NUMBER!!!
  470.  
  471.      MAKE CHECKS PAYABLE TO RALPH B SMITH JR - ALL CHECKS MADE OUT TO
  472.      CLYSMIC SOFTWARE WILL BE RETURNED!!!
  473.  
  474.                                         
  475.  
  476.                                 Ralph B Smith Jr
  477.                                 clySmic Software
  478.                                  P. O. Box 2421
  479.                                Empire State Plaza
  480.                                 Albany, NY 12220
  481.  
  482.                               CompuServe 76156,164
  483.